home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / ARGONET / PD / ARGO_RELATED / FETCHMAIL.ZIP / VIX / ReadMe
Text File  |  1997-05-04  |  9KB  |  253 lines
  1.                                   FetchMail 1.11
  2.                                   ~~~~~~~~~~~~~~
  3.  
  4.  
  5. The obligatory notice: This software has got diddly/squat to do with Argo.
  6.                        If it dies, don't ring the support line. Instead sit
  7.                        down and write me a nice votriolic flame. Then, write
  8.                        me another email describing what happened.
  9.                        rmurray@argonet.co.uk
  10.  
  11.  
  12.  
  13. PART ONE - FETCHMAIL
  14. ~~~~~~~~~~~~~~~~~~~~
  15.  
  16. Everybody wants a way to be able to save out their email file in a readable
  17. format.
  18. Argo, understandably, are none too thrilled at the idea of telling everybody
  19. how the mail scrambling system works.
  20.  
  21. So people start hacking the mail system. It's a brilliant idea, twiddle this
  22. and twiddle that. But it can cause great confusion. Imagine also what could
  23. happen if the next DTposty code is written in C with the scrambling system
  24. hardcoded?
  25.  
  26. What is needed is some kind of addition to do the mail decoding as required.
  27. Something that is as secure as DTposty (if not more so) and doesn't let just
  28. any old person loose on the email files.
  29.  
  30.  
  31. Something like FetchMail.
  32.  
  33.  
  34.  
  35. FetchMail reads which users are defined (maximum of ten), which users have
  36. which mailboxes, and password protection is applied throughout.
  37.  
  38.  
  39. To use FetchMail:
  40.  
  41.   1. Load it up and click on the iconbar icon.
  42.  
  43.   2. Select a mailbox using the up/down arrows.
  44.  
  45.   3. Enter the password (if there is one).
  46.  
  47.   4. Select which mailboxes you want retrieved. The "Standard", "Saved" and
  48.      "Log" is exactly as in Posty.
  49.  
  50.   5. Select which of the strip options you want.
  51.      Sorry, the "Strip cute babes in a Beverley Hills teledrama" option is
  52.      not available.
  53.  
  54.      A quirk is that binaries following the signature will be stripped as
  55.      anything from the "-- " to the next message is treated as the signature.
  56.  
  57.      NOTE: MIME binaries are not stripped at this time. However the bit about
  58.            the signature quirk (above) still applies.
  59.  
  60.   6. Enter the pathname in the icon or drag the directory icon to the
  61.      destination. The base name is always your email prefix (ie, "rmurray"
  62.      or "adopt" or "xina" etc).
  63.      Upon dragging, the save widget will be kicked into action. If you don't
  64.      do this, then click the "Fetch my mail" icon.
  65.      "Cancel" quits.
  66.  
  67.  
  68. All mail is stored in a directory based upon your username. If you want
  69. something different then use the writable icon. Inside this directory are up
  70. to three files called "Standard", "Saved" or "Log". Which ones depends upon
  71. your selected options.
  72.  
  73.  
  74.  
  75.  
  76.  
  77. PART TWO - THE PREPROCESSOR
  78. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  79.  
  80. This is a new and powerful addition based on a need to filter out the crap
  81. (are you ever likely to want to call some lousy 1-800 number for pictures of
  82. naked females?) and also from a desire to 'Ack' every incoming message in a
  83. way similar to the support@argonet.co.uk thing.
  84.  
  85.  
  86. This can now be set up to preprocess automatically. Drag the stuff from the
  87. "VIX" directory in this archive into Voyager's VIX directory. Next time you
  88. load Voyager, it will be loaded. The VIX support checks to see if you have
  89. incoming mail. If so, the preprocessor kicks into action. Otherwise it does
  90. not...
  91.  
  92.  
  93. Load FetchMail in the normal way. Use the menu or click ADJUST on the iconbar
  94. icon to open the preprocessor configuration file.
  95.  
  96.   "kill-file"   is when the message is bounced to sender. You don't get to see
  97.                 it.
  98.  
  99.   "bit-bucket"  is when the message is removed from the incoming mail, going
  100.                 to the proverbial bit-bucket.
  101.  
  102.   "auto-ack"    is where any incoming message gets an 'ack'.
  103.  
  104.   "keep weeded" is where filtered messages are stored in !FetchMail.Data.Dead
  105.                 just in case they were useful.
  106.  
  107.   "diff reply"  is not yet implemented.
  108.  
  109.  
  110. Click SAVE to set your options. Now open up the !FetchMail.Data directory.
  111.  
  112.   Config.bit-bucket     Enter here the names of anybody you want to junk. As
  113.                         you can see from the example - I've had a fair old
  114.                         amount of junk-email.
  115.  
  116.   Config.kill-file      Enter here the names of anybody you want to bounce
  117.                         messages from. This is most suitable for ramming home
  118.                         a point to people you don't particularly like. Don't
  119.                         use with spammers. If their address hasn't been faked,
  120.                         they could well have moved on. Or they'll flame you
  121.                         back.
  122.  
  123.   Dead.*                Will be either "kill-file" or "bit-bucket" and it'll
  124.                         contain filtered messages if you chose to keep weeded
  125.                         messages. The message is written out with all the
  126.                         header details and everything so you can, if wanted,
  127.                         import into DTposty.
  128.  
  129.   Forms                 If this file exists, it contains Argo form CGI
  130.                         messages, suitable for some kind of auto-parser?
  131.  
  132.   MessageIDs            If exists, contains currently valid Message ID strings
  133.                         so older messages don't get preprocessed several
  134.                         times.
  135.  
  136.   Options               The options file. Format is easy to work out, but it
  137.                         is even easier to use FetchMail. :-)
  138.  
  139.   Responses.autoack     Placed at the beginning of automatically acknowledged
  140.                         messages. Followed by:
  141.                         --8<--------
  142.                         Your message to : <yourname>
  143.                         with subject    : <subject>
  144.                         was delivered safely.
  145.                         --8<--------
  146.                         There is no time given... That's in the message
  147.                         header.
  148.  
  149.   Responses.killfile    Placed at the beginning of bounced messages to
  150.                         explain why their message was bounced. You might like
  151.                         to be a little less subtle and include stuff like
  152.                         "In my opinion you are a moron and I'm not reading
  153.                          any of your drivel!". :-)
  154.  
  155.                         Followed by:
  156.                         --8<--------
  157.                         Subject       : <subject>
  158.                         Originally to : <yourname>
  159.  
  160.                         Message text follows...
  161.                         --8<--------
  162.  
  163.                         And between two 'cut marks' ("--8<--------") is quoted
  164.                         the entire message. :-)
  165.  
  166.   Responses.signoffs.*  The filename is your email name (see rules below) and
  167.                         is used as your signature. Email name taken from
  168.                         message so people with multiple accounts can have
  169.                         their own signatures.
  170.  
  171.                         Scanning left to right through the email name, stop
  172.                         at "." or "@" or after ten characters - whichever
  173.                         occurs first.
  174.  
  175.                         For example:
  176.                           rmurray@argonet.co.uk         "rmurray"
  177.                           claire.danes@argonet.co.uk    "claire"
  178.                           reallylongname@argonet.co.uk  "reallylong"
  179.  
  180.   The read-in files of Data.* may contain lines beginning ";". If so, these
  181.   lines will be skipped.
  182.  
  183.   If you find duplicate last lines appearing, simply add a blank line to the
  184.   end of the offending file.
  185.  
  186.  
  187. Now the fun part. Doing it.
  188.  
  189. Call FetchMail. Pass as CLI parameter "-preprocess" (in lower case and with
  190. the dash). If this sounds confusing, set up the VIX. Makes it all nice and
  191. automated... Automagic even. :-)
  192.  
  193.  
  194. If it all goes horribly wrong, DO NOT RUN FETCHMAIL. Look inside. Your
  195. original email file will be in there called "angela". Indeed, FetchMail will
  196. REFUSE to run if the "angela" file exists - to prevent the slightest
  197. possibility of mail loss.
  198.  
  199.  
  200. Ack'd messages have "Ack: " prefixed to the subject. This is consistant with
  201. the MailStrip software, and allows FetchMail to detect Acks from both programs
  202. so Acks will not be Ackd endlessly.
  203.  
  204.  
  205. Note: Messages from "support@argonet" or "null.user" or with the subject
  206.       "Web space" will NOT be ACKed.
  207.  
  208.  
  209. This is an early copy of FetchMail. I would appreciate ALL bug reports,
  210. queries and comments - no matter how weird.
  211.  
  212.  
  213. Thanks.
  214.  
  215.  
  216. rmurray@argonet.co.uk
  217.  
  218.  
  219.  
  220.  
  221.  
  222. ALSO INCLUDED
  223. ~~~~~~~~~~~~~
  224.  
  225. !FormDec
  226.   Alpha version of a Form decoder. Doesn't handle text areas well and isn't
  227.   bomb proof - but will take one (only one, at this time) Argo form CGI
  228.   message and display it 'smartly' on the screen. You design a template with
  229.   the information where you want it, and it'll put the info there!
  230.  
  231.   Instructions included within.
  232.  
  233.  
  234. vix
  235.   Copy the "FetchMail" directory within to "!Voyager.VIX". Now when mail
  236.   download is complete, FetchMail's preprocessor will be automatically
  237.   started.
  238.  
  239.  
  240.  
  241.  
  242.  
  243. COMING SOON:
  244.  
  245. More work on !FormDec to make it kinda cool. :-)
  246.  
  247. The ListServer, or at least an early version of it. It'll be based upon my
  248. InfoSys2 listserver (in use with FidoNet). It is a real pig to set up (at 
  249. this time - most things are 'hardcoded' the way I like them), but when running
  250. it is a powerful command-based server with automatic (and smart) UUcode
  251. facilities.
  252.  
  253.